home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 23 / AMIGAplus Sonderheft 23 (2000)(Falke)(DE)[!].iso / Updates / Archivierer / UnZip_v5.32 / Docs / unzip.doc < prev    next >
Text File  |  1999-11-06  |  45KB  |  910 lines
  1.  
  2. UNZIP(1L)                                               UNZIP(1L)
  3.  
  4. NAME
  5.        unzip  -  list, test and extract compressed files in a ZIP
  6.        archive
  7.  
  8. SYNOPSIS
  9.        unzip    [-Z]    [-cflptuvz[abjnoqsCLMVX$]]     file[.zip]
  10.        [file(s) ...]  [-x xfile(s) ...] [-d exdir]
  11.  
  12. DESCRIPTION
  13.        unzip  will  list,  test,  or  extract  files  from  a ZIP
  14.        archive, commonly found on MS-DOS  systems.   The  default
  15.        behavior  (with no options) is to extract into the current
  16.        directory (and subdirectories below it) all files from the
  17.        specified ZIP archive.  A companion program, zip(1L), cre-
  18.        ates ZIP  archives;  both  programs  are  compatible  with
  19.        archives created by PKWARE's PKZIP and PKUNZIP for MS-DOS,
  20.        but in many cases the program options or default behaviors
  21.        differ.
  22.  
  23. ARGUMENTS
  24.        file[.zip]
  25.               Path of the ZIP archive(s).  If the file specifica-
  26.               tion is a wildcard, each matching file is processed
  27.               in  an order determined by the operating system (or
  28.               file system).  Only the filename can be a wildcard;
  29.               the  path  itself cannot.  Wildcard expressions are
  30.               similar to Unix egrep(1) (regular) expressions  and
  31.               may contain:
  32.  
  33.               *      matches a sequence of 0 or more characters
  34.  
  35.               ?      matches exactly 1 character
  36.  
  37.               [...]  matches  any  single  character found inside
  38.                      the brackets;  ranges  are  specified  by  a
  39.                      beginning character, a hyphen, and an ending
  40.                      character.  If an  exclamation  point  or  a
  41.                      caret (`!' or `^') follows the left bracket,
  42.                      then the  range  of  characters  within  the
  43.                      brackets  is complemented (that is, anything
  44.                      except the characters inside the brackets is
  45.                      considered a match).
  46.  
  47.               (Be  sure  to quote any character that might other-
  48.               wise be interpreted or modified  by  the  operating
  49.               system,  particularly  under  Unix and VMS.)  If no
  50.               matches are found, the specification is assumed  to
  51.               be  a literal filename; and if that also fails, the
  52.               suffix .zip is appended.  Note that self-extracting
  53.               ZIP  files  are  supported,  as  with any other ZIP
  54.               archive; just specify  the  .exe  suffix  (if  any)
  55.               explicitly.
  56.  
  57. Info-ZIP             3 November 1997 (v5.32)                    1
  58.  
  59. UNZIP(1L)                                               UNZIP(1L)
  60.  
  61.        [file(s)]
  62.               An  optional  list  of  archive  members to be pro-
  63.               cessed, separated by spaces.   (VMS  versions  com-
  64.               piled  with  VMSCLI defined must delimit files with
  65.               commas instead.  See -v in OPTIONS below.)  Regular
  66.               expressions (wildcards) may be used to match multi-
  67.               ple members; see above.  Again, be  sure  to  quote
  68.               expressions  that  would  otherwise  be expanded or
  69.               modified by the operating system.
  70.  
  71.        [-x xfile(s)]
  72.               An optional list of archive members to be  excluded
  73.               from  processing.   Since wildcard characters match
  74.               directory separators (`/'), this option may be used
  75.               to  exclude  any  files that are in subdirectories.
  76.               For example, ``unzip  foo  *.[ch]  -x  */*''  would
  77.               extract  all  C source files in the main directory,
  78.               but none in any  subdirectories.   Without  the  -x
  79.               option,  all  C  source  files  in  all directories
  80.               within the zipfile would be extracted.
  81.  
  82.        [-d exdir]
  83.               An optional directory to which  to  extract  files.
  84.               By default, all files and subdirectories are recre-
  85.               ated in the current directory; the -d option allows
  86.               extraction in an arbitrary directory (always assum-
  87.               ing one has permission to write to the  directory).
  88.               This  option need not appear at the end of the com-
  89.               mand line; it is also accepted before  the  zipfile
  90.               specification  (with  the  normal options), immedi-
  91.               ately after the zipfile specification,  or  between
  92.               the  file(s)  and  the  -x  option.  The option and
  93.               directory may be  concatenated  without  any  white
  94.               space  between  them,  but note that this may cause
  95.               normal shell behavior to be suppressed.  In partic-
  96.               ular, ``-d ~'' (tilde) is expanded by Unix C shells
  97.               into the name of the  user's  home  directory,  but
  98.               ``-d~''  is treated as a literal subdirectory ``~''
  99.               of the current directory.
  100.  
  101. OPTIONS
  102.        Note that,  in  order  to  support  obsolescent  hardware,
  103.        unzip's  usage  screen  is  limited  to 22 or 23 lines and
  104.        should therefore be considered  only  a  reminder  of  the
  105.        basic  unzip  syntax rather than an exhaustive list of all
  106.        possible flags.  The exhaustive list follows:
  107.  
  108.        -Z     zipinfo(1L) mode.  If the first option on the  com-
  109.               mand line is -Z, the remaining options are taken to
  110.               be zipinfo(1L) options.  See the appropriate manual
  111.               page for a description of these options.
  112.  
  113.        -A     [OS/2,  Unix DLL] print extended help for the DLL's
  114.               programming interface (API).
  115.  
  116. Info-ZIP             3 November 1997 (v5.32)                    2
  117.  
  118. UNZIP(1L)                                               UNZIP(1L)
  119.  
  120.        -c     extract files  to  stdout/screen  (``CRT'').   This
  121.               option  is similar to the -p option except that the
  122.               name of each file is printed as  it  is  extracted,
  123.               the  -a option is allowed, and ASCII-EBCDIC conver-
  124.               sion is  automatically  performed  if  appropriate.
  125.               This  option  is  not  listed  in  the  unzip usage
  126.               screen.
  127.  
  128.        -f     freshen existing files, i.e.,  extract  only  those
  129.               files that already exist on disk and that are newer
  130.               than the disk copies.   By  default  unzip  queries
  131.               before  overwriting,  but the -o option may be used
  132.               to suppress the  queries.   Note  that  under  many
  133.               operating  systems,  the  TZ (timezone) environment
  134.               variable must be set correctly in order for -f  and
  135.               -u  to  work  properly  (under Unix the variable is
  136.               usually set automatically).  The reasons  for  this
  137.               are somewhat subtle but have to do with the differ-
  138.               ences between DOS-format file times  (always  local
  139.               time) and Unix-format times (always in GMT/UTC) and
  140.               the necessity to compare the  two.   A  typical  TZ
  141.               value  is  ``PST8PDT''  (US Pacific time with auto-
  142.               matic  adjustment  for  Daylight  Savings  Time  or
  143.               ``summer time'').
  144.  
  145.        -l     list  archive  files  (short  format).   The names,
  146.               uncompressed file sizes and modification dates  and
  147.               times  of  the  specified  files are printed, along
  148.               with totals for all files specified.  If UnZip  was
  149.               compiled  with  OS2_EAS defined, the -l option also
  150.               lists columns for the sizes of stored OS/2 extended
  151.               attributes  (EAs)  and  OS/2  access  control lists
  152.               (ACLs).  In addition, the zipfile comment and indi-
  153.               vidual  file comments (if any) are displayed.  If a
  154.               file was archived from a  single-case  file  system
  155.               (for  example,  the old MS-DOS FAT file system) and
  156.               the -L option was given, the filename is  converted
  157.               to lowercase and is prefixed with a caret (^).
  158.  
  159.        -p     extract  files  to  pipe (stdout).  Nothing but the
  160.               file data is sent to  stdout,  and  the  files  are
  161.               always extracte